Terminal and merchant resolution rules
For routes that use transaction or report request bodies, terminal and merchant are resolved in this order:
- Use
terminalfrom the request if provided. - If not provided, use the currently selected terminal (session/default context).
- If still not available, use the first configured terminal.
- For
merchant, use request value if provided. - If not provided, use the default merchant for the resolved terminal.
Important behavior:
merchantis always resolved for the final terminal.- If a requested or resolved terminal has no valid merchant, the request fails.
- If no terminal can be resolved, the request fails.
- If you send both fields, they must represent a valid pair in current configuration.
Integration recommendation:
- Use
/terminalsresponse as the source of validterminal+merchantcombinations.